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Traversals of data structures are ubiquitous in programming. Consequently, it is important to be 
able to characterise those structures that are traversable and understand their algebraic properties. 
Traversable functors have been characterised by McBride and Paterson as those equipped with a 
distributive law over arbitrary applicative functors; however, laws that fully capture the intuition 
behind traversals are missing. This article is an attempt to remedy this situation by proposing laws 
for characterising traversals that capture the intuition behind them. To support our claims, we prove 
that finitary containers are traversable in our sense and argue that elements in a traversable structure 
are visited exactly once. 

1 Introduction 

Traversals of data structures are ubiquitous in programming. Consequently, it is essential for the writer of 
mathematically structured programs to have a precise understanding of the abstract structure of traversals 
and of their algebraic properties. 

There are many notions of traversal, but in this article, we will focus on the traversals of functors 
G : Set — )■ Set as given by a family of natural transformations 5^ : GF — )• FG over applicative func- 
tors F 1 1^. This notion of traversal is quite abstract but practical for structuring and reasoning about 
programs IHISIH, and encompasses other notions of traversals, such as generating a list of elements. 

Usually, distributive laws are required to respect structure via coherence laws lfT2l . However, the 
characterisation of traversability in terms of a distributive law given by McBride and Paterson is incom- 
plete as no coherence laws are required to hold and one can write distributive laws that do not follow the 
intuition of what a traversal should be. Consequently, a distributive law is not enough and the definition 
of a traversal needs to be strengthened to avoid bad instances. However, there seems to be no consensus 
of precisely what a traversal should be. 

Moggi et al. 1 1 1 ,1 define traversals of a functor G over a functor F to be a family over Gl of dis- 
tributive laws 5f.QY : GsF — )■ FGg. Here, Gs is a family over G\ of functors obtained from the pullback 

of the diagram 1 — ^Gl < ^' GX . The family of morphisms provides an easy way to express shape 
preservation (the shape of G before traversing the structure is the same as the shape of G after traversing 
it). Nevertheless, we find this notion of traversability to be a bit unsatisfactory since it allows traversals 
that go over the same element more than once. Gibbons and Oliveira [ 8 1 proposed many properties that 
should hold for traversals, but they did not seek to obtain a lawful definition of traversability. Further- 
more, they failed to recognize the law that would prevent traversing over an element twice. 

The main contribution of this article is to establish coherence laws for the distributive law that capture 
the intuition of traversals. The laws can be expressed by simple equations; they are shown to hold for the 
largest class known of traversable functors, namely finitary containers; and they are shown to prohibit the 
"bad" traversals identified by Gibbons and Oliveira. Additionally, we complete the Haskell traversable 
class so that it contains the three ways in which distributive laws can be expressed ||4l|3l. Furthermore, 
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we characterize traversability categorically in two ways: as a 2-functor between particular 2-categories, 
and as a distributive law over a monoidal action. 

The article is organised as follows. Section [2] is written with the Haskell programmer in mind; we 
review applicative and traversable functors, and we motivate and present the proposed laws. We work in 
the category of sets and total functions from section [3] onwards, where we show that finitary containers 
are traversable in our sense. In section |4] we analyze some consequences of the laws and we argue that 
the laws imply that every position in the structure is visited exactly once. Additionally, a categorical 
interpretation of traversability is given. Finally, in section |5] we conclude and discuss future work. 

2 Traversals in Haskell 

In this section we give our motivation for and introduce our proposed laws for traversals using the func- 
tional language Haskell. We give an intuition of why the laws are reasonable but we defer a more rigorous 
explanation to the following sections. 

Intuitively, a traversal of a data structure is a function that collects all elements in a data structure 
in a given order. A more abstract formulation was proposed by Moggi et al. [11] where a traversal 
is a distributive law of a functor (representing the data structure in question) over an arbitrary monad. 
McBride and Paterson extended the notion of traversability to be a distributive law of a functor over an 
arbitrary applicative functor jlOl . As we will see next, the notion of a distributive law is general enough 
to include the basic notion of a function listing the elements of a data structure. 

2.1 Applicative Functors 

An applicative functor |[TOl is an instance of the class 

class Functor f =^ Applicative/ where 
pure ::x -^fx 

(®) v.fia^b) ^fa^fb 

such that the following coherence conditions hold. 

identity pure id®u =u 

composition pure {■)®u®v®w = u®{v®w) 

homomorphism pure g ® pure x = pure {g x) 

interchange u ® pure x = pure {Xg g x)®u 

Every monad is an applicative functor, but applicative functors are more general. For example, every 
monoid determines an applicative functor (which is not a monad): 

newtype K a b = K { unK : : a } 

instance Monoid a =^ Applicative {K a) where 
pure x = K d) 

f®x = K {unK f ® unK x) 

where is the monoid unit, and © is the monoid multiplication. 
Applicative functors are closed under identity and compositioiiQ 

'For brevity, throughout the article we omit the required Functor instances. The complete source code can be found at 
http : //www . f ceia . unr . edu . ar/~mauro/ 
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newtype Id a = Id { unid : : a } 

instance Applicative Id where 
pure = Id 

f®x = Id [unldf {unldx)) 
newtype Cf ga = Comp { unC wf {g a)} 

instance {Applicative f , Applicative g) =^ Applicative {Cf g) where 
pure = Comp ■ pure ■ pure 
f®x = Comp {pure (®) ®unCf®unCx) 

2.2 The class of Traversable functors 

McBride and Paterson propose a traversal to be a distributive law of a functor over all applicative func- 
tors [ilOil . Hence, the class of traversable functors is defined: 

class Functor t =^ Traversable t where 

traverse Applicative f =^ {a — t-/ b) ^ t a — t-/ {t b) 
dist Applicative f ^ t {f a) — t-/ {t a) 

traverse/ = dist -fmapf 
dist = traverse id 

A minimal instance should provide a definition of either traverse or dist, as one can be defined by 
the other, as shown by the default instances above. 

Example 2.1. The canonical example of a traversable functor is the list functor. 

instance Traversable [ ] where 
dist [ ] = pure [ ] 
dist {x:xs) = pure (:) ®x®dist xs 

Another typical example is that of binary trees with information in the nodes: 

data Bin a = Leaf \ Node {Bin a) a {Bin a) 

instance Traversable Bin where 
dist Leaf = pure Leaf 

dist {Node I ar) = pure Node ® dist I® a® dist r 

Our last example is the identity functor. 

instance Traversable Id where 
dist {Idx) =fmap Idx 

Remark 2.2. Given a Traversable functor, it is possible to construct a list of its elements by traversing it 
over an accumulator, as done by the function toList: 

toList:: Traversable t^ta^ [a] 
toList = unK ■ dist -fmap wrap 
where wrap -.-.x^ K[x]a 
wrapx = K [x] 
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2.3 The need for laws 

Notice that no coherence conditions are required to hold for instances of traverse (or dist) in the class 
definition above. Hence, it is possible to instantiate definitions of dist that do not follow our intuition of 
what a traversal should be. Consider the following functions implementing a distributive law between 
lists and an arbitrary applicative functor 

distL,distL! , distil' Applicative f ^ \f a\ —^f [a] 
distL _ = pure [ ] 

distl! [ ] = pure [ ] 

distL' [x\ = pure [ ] 

distL' {x:y:xs) = pure (:) ®x® distL' {y:xs) 

distL" [ ] = pure [ ] 

distL" (x:xs) = pure ( : ) ® x' ® distL" xs 

where x' = pure {Xx y ^ x) ® x ® x 

The functions have the correct type but they are not traversals: the first one (distL) does not even try to 
traverse the list, the second one (distL') does not visit the last element of the list, and the last one (distL") 
collects each applicative effect twice (but not the data). Consequently, in order for the Traversable class 
to capture the intuition behind traversals, it needs to require certain laws to hold in order to prohibit 
definitions such as those of the three functions above. 



2.4 Reformulation of the Traversable class 

We conclude this section with our proposed class of Traversable functors. It differs from the previous 

one in two aspects. 

• In addition to traverse and dist, a minimal instance can also be given by defining a function 

consume :: Applicative f ^ (t a ^ b) ^ t {J a) -^f b. 

• It requires two laws to hold. 

We define the class of traversable functors to be: 

class Functor t Traversable t where 

traverse ■.■.Applicative/ =^ (a — )•/ b) ^ t a — >■/ {t b) 
dist ■.■.Applicative f ^ t {f a) — t-/ {t a) 
consume:: Applicative f =^ {t a ^ b) ^ t if a) — )■/ b 

traverse f = dist-fmapf 
dist = consume id 

consume f =ftnapf ■ traverse id 

subject to the following laws: 

Unitarity dist -finap Id = Id 

Linearity dist -frnap Comp = Comp -finap dist ■ dist 

The same laws expressed in terms of traverse are: 
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traverse {Id •/) = Id -fmapf 

traverse {Comp ■fmap g •/) = Comp -finap (traverse g) ■ traverse/ 

We leave as an exercise to the reader to express the laws in terms of consume. 

Note that, since the identity functor is applicative, the laws for traverse imply functoriality even 
without the type class requirement. Hence an alternative definition would not require traversable functors 
to be an instance of the Functor class, but just to provide an instance of traverse subject to the two laws 
above. In this case, providing definitions just for dist or consume would not be enough. 

In the following sections we show that these laws are reasonable for a large class of functors, and 
analyse how they prohibit wrong definitions such as distL, distL' and distL" . 



3 Canonical Traverse for Finitary Containers 

Categorically, applicative functors are functors F : Set — Set, together with natural transformations: 

rix : X ^FX (unit) 
®x,Y ■ F{Y^) X FX ^ FY (application under F) , 

where is the function space (cartesian closure), together with equations expressing basically that rjyx 
injects pure functions Y^ to functions under in F{Y^) and ® respects this (see [10] for the details). 
In category theory it is more convenient to work with the following equivalent definitions: 

Definition 3.1 (Applicative Functor). An applicative functor is equivalently either of: 

( i) A functor F : Set — )■ Set which is lax monoidal with respect to the cartesian product and whose 
strength is coherent with the monoidal structure, which is to say that the following diagram com- 
mutes: 

{FXxFY)xZ 

llxZ 

F{XxY)xZ- 



FX X (FY X Z) — — FX X F{Y x Z) 

F((X X F) X Z) — ^F(X x(Yx Z)) 



where o is strength, }X is the monoidal action and a is associativity. Note that all Set functors are 
strong so the key requirement here is the coherence with the monoidal action. 

( ii) A pointed lax monoidal functor F : Set — )• Set, where the unit ofF, r\x'-X ^ FX, coincides with the 
unit of the monoidal structure V : \ ^ F\ in that T]i = V; and the multiplication }Xxj '■ FX x FY — t- 
F{X xY) is coherent with r\ in the sense that 




FX X FY 



■F{XxY) 



commutes. 

The equivalence of ^ and ^ is straightforward. 
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Definition 3.2 (Applicative Morphism). Let F and G be applicative functors. An applicative morphism 
is a natural transformation T . F ^ G that respects the unit and multiplication. That is, a natural 
transformation T such that the following diagrams commute. 





FX 



GX 



FX X FY 

Y 

GXxGY 



^x.y 



■F{XxY) 
G(X X Y) 



Applicative functors and applicative morphisms form a category £/. 

The identity functor 1 is an applicative functor, and composition of applicative functors is applicative. 
Hence, applicative functors form a (large) monoid, with functor composition o as multiplication and 
identity functor 1 as unit. 

In [ 10|, traversable functors are characterised as those which distribute over all applicative functors. 
There, distributivity of a traversable T over applicative F's meant only the existence of natural transfor- 
mations of type TF =^ FT. However, without further constraints this characterisation is too coarse. Here 
we refine the notion of a traversable functor as follows: 

Definition 3.3 (Traversable Functor). A functor T : Set — Set is said to be traversable if there is a family 
of natural transformations 

5| : TFX FTX 

natural in F and respecting the monoidal structure of applicative functor composition. Explicitly, for all 
applicative F, G : Set — Set and applicative morphisms a : F ^ G, the following diagrams of natural 
transformations commute: 



TF^^FT 



FTG 



Tl 



IT 



Ta 

TG 



5° 

naturality 



GT 




TFG 



gFG 

linearity 



FGT 



unitanty 

We sometimes call the family 5 a traversal of T. 

Next we introduce a class of functors, which are always traversable: so-called ^zn/fary containers llH. 
Definition 3.4 (Finitary Container). A finitary container is given by 

( i) a set S of shapes 

( ii) an arity ar : 5 — )■ N 

To each container (5, ar) one can assign a functor Ext(5,ar) : Set — t- Set called the extension of (5',ar) 
defined for each set X as the set of (dependent) pairs {s,f) where s £ S and f € X^'^^ where X", for 
« G N, is the n-fold product X x ■ ■ ■ x X 



Finitary containers are also known as finitary dependent polynomial functors ||6l or functors shapely 
over lists lITTIl . Moggi et al. ifTTl define a canonical traversal by monads for shapely functors. It is also 
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indicated that this traversal could be generalised from monads to all monoidal functors. Here we show 
that all Unitary containers (shapely functors) are traversable in our sense. Explicitly: for each extension of 
a finitary container we construct a natural family of distributive laws 5 satisfying linearity and unitarity. 
As extensions of containers are sums of products we proceed in stages. 

Lemma 3.5. Traversable functors are closed under arbitrary sums. 

Proof. Let T^, 5 G 5 be a family of traversable functors with traversals 5^. We must show that Y.ses'^s is 
traversable. To this end we construct, for each X: 



L^esTsFX 



Lses S, 



[F(inLr,Z)],es 

■ 1,^5 FT,X ' ' F ZX , 

where \n]^y = {s,y) and where [ ]ses is case splitting on S. Naturality, unitarity and linearity are all easily 
checked. □ 

Lemma 3.6. Traversable functors are closed under finite products. 

Proof. Let 5 be a traversal for T, S finite. Then T^ is just iterated product T x ■ ■ ■ x T , |5| -times, and 
therefore we can use multiplication /i of any applicative functor F to construct a 5^ : T^F =^ FT^ hy 
finite iteration. Namely, define jj,'' : F''X — ^ F{X^), ^ G N by /x" = v, /x^ = If , = }X-{\p x jx'^) and 
put = /^I'^l • Sl'^l. Now naturality follows by naturality of everything in sight; unitarity from the fact 
that ji for the identity monoidal functor is just the identity. To see linearity just observe commutativity 
of the following for each G N: 



FiGXY 




{FGXY 



■ FG{X^) 



□ 

Theorem 3.7. All extensions of finitary containers are traversable. 

Proof. Extensions of finitary containers are sums of finite products so the results follows directly by the 
previous two Lemmas 3.6 and 3.5 □ 



It remains an open question whether the traversals defined in the above theorem are essentially 
unique. In other words, whether there is an isomorphism between permutations of arities on finitary 
containers and their traversals. 



4 Analysis of the Laws 
4.1 Unitarity 

Unitarity implies the so-called "purity law" 5^ ■ T [rj] = rjT f^. In fact, the two laws are equivalent. 

To see this, we notice that the identity functor is initial in the category £/ of applicative functors 
and applicative morphisms, with the universal map given by rj. Hence we obtain the purity law by the 
following naturality square. 
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5i=id 




5^ 

Conversely, instantiating the purity law for the identity functor, we obtain unitarity. 

Unitarity (and hence, the purity law) is stronger than shape preservation. For example, returning the 
mirror of a binary tree is forbidden. By requiring unitarity to hold we are implicitly stating that what 
matters in a traversal is the order in which the effects are collected. 

Note that unitarity implies that each element is traversed at least once. Hence distributive laws such 



as distL and distL' of Section 2.3 do not respect unitarity. 



4.2 Linearity 

One of the sought-after effects of the laws is to rule out traversals that go more than once over each 
element. We will show that this kind of definition does not respect the linearity law by analysing the 
simple example of traversing the identity functor. 

Consider the following distributive law of the identity functor over an arbitrary applicative functor, 

5| : 1{FX)=FX — ^FXxFX ^F{XxX) '^^^^^ FX = F{IX) 

where dx{x : X) = {x,x) : X xX is the diagonal function. The distributive law 5 traverses over the data 
twice so it is not a proper traversal. Although unitarity holds for 5, linearity does not, as the following 
counter-example shows. 

Consider the applicative functor L arising from the list monad, and [[], [1]] G L(L(N)). Calculating, 
we obtain that linearity does not hold: 

smm = mum] / [d,[i],d,[i]] = ^^(^^^[dji]]) 



A similar counter-example can be constructed for the traversal of lists distL" of Section 2.3 



distL"^'[[[],[[im = [[],[],[],[[[!]]]] / [[],[], [[[!]]],[[[!]]]] = distL"^oLidistL"^)[[U[l]]]] 

These counter-examples suggest that distributive laws that traverse over elements more than once 
will violate the linearity law. This consequence of the linearity law was apparently overlooked in [Si. 



4.3 Preservation of Kleisli Composition 

The following lemma was proved as a property of the canonical distributivity of finitary containers by 
Moggi et al. fTT] and under label sequential composition of monadic traversals in [ 8]. Here, however, 
we can prove it as a consequence of the definition of traversability. 

Lemma 4.1. Let {T,5) be a traversable functor Then for any commutative monad M, we have that 5 
preserves Kleisli composition, i.e. 

TMM — ^ MTM — ^ MMT 



rflat 

I 

TM 



gM 



flatr 

I 

MT 
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where flat is the multiplication of the monad M. 

Proof. The commutative monad M induces a commutative applicative functor. The muhiplication of the 
monad flat : MoM — M is an applicative morphism (thanks to commutativity). Hence, the following 
diagram commutes because of preservation of composition and naturality of 8. 




□ 



4.4 Categorical meaning of the laws 

Let App be the 2-category with one object, arrows: applicative functors and 2-cells: applicative mor- 
phisms. And let / : App — Cat be the inclusion into the 2-category of categories sending the object of 
App to Set. Then a traversable functor is exactly a co-lax natural transformation 7 — )• 7 : App — )• Cat. See 
191 for the elementary 2-categorical notions. 

It's interesting to compare this to the following characterisation in terms of distributive laws of 
monoidal actions 1,13,1 . Consider the strict monoidal category (j#,o,l) of applicative functors and ap- 
plicative morphisms with the monoidal action applicative functor composition. This category induces a 
monoidal action over Set, where the action () : £^ >^ Set — )• Set is simply application of the functor, i.e. 
FOX ^ FX and FOf ^ Ff. 

A distributive law of a functor T over the monoidal action of is a binatural transformation 
5 : r(_0-) — 7- -0(r_), satisfying the axioms: 



T{{FoG)OX) 

id 

T{FO{GOX)) ■ 



gFoG 
"X 



"aox 



■FOT{GOX) 



{FoG)OTX 

id 

■FOiGOTX) 




T{10X) 



S'x 



lOTX 



Hence, a functor is traversable when it comes equipped with a distributive law over the monoidal 
action of applicative functors. 



5 Conclusion 

The definition of traversability as a distributive law needs to be strenghtened in order to capture the 
intuitive notion of a traversal. We have provided two simple laws and shown that these laws hold for 
finitary containers, and we have provided evidence that they restrict traversals to those that go over each 
position exactly once. 

Finitary containers are the largest known class of traversable functors, and we are not aware of any 
functor that is traversable and it is not a finitary container. It has been conjectured that every traversable 
functor is a finitary container ifTTI . but proof of this has eluded us. One possiblity for proving it might be 
to take a syntactic approach and restrict the proof to functors in a given universe. 
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The characterisation of traversals as a distributive law over applicative functors is interesting because 
it leads to other kinds of traversability by changing distributivity over applicative functors by distributiv- 
ity over others kinds of functor. For example, one might consider a distributive law over all commutative 
applicative functors i.e. applicative functors F for which 

Fs\Napx Y ofJ- = ° swa f y : FX x FY —?- F{Y x X) , 

where swap^ y'-XxY^YxX is the obvious morphism. Then, one would obtain a class of traversable 
functors that includes finitary quotient containers |i2i| such as unordered pairs, where commutativity of 
the applicative functor is essential. 

Acknowledgement We thank the anonymous reviewers for their constructive criticism. 
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